home *** CD-ROM | disk | FTP | other *** search
/ Halting the Hacker - A P…uide to Computer Security / Halting the Hacker - A Practical Guide to Computer Security.iso / rfc / rfc1650.txt < prev    next >
Text File  |  1997-04-01  |  40KB  |  1,124 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                      F. Kastenholz
  8. Request for Comments: 1650                            FTP Software, Inc.
  9. Category: Standards Track                                    August 1994
  10.  
  11.  
  12.                   Definitions of Managed Objects for
  13.              the Ethernet-like Interface Types using SMIv2
  14.  
  15. Status of this Memo
  16.  
  17.    This document specifies an Internet standards track protocol for the
  18.    Internet community, and requests discussion and suggestions for
  19.    improvements.  Please refer to the current edition of the "Internet
  20.    Official Protocol Standards" (STD 1) for the standardization state
  21.    and status of this protocol.  Distribution of this memo is unlimited.
  22.  
  23. Table of Contents
  24.  
  25.    1. Introduction ..........................................    1
  26.    2. The SNMPv2 Network Management Framework ...............    2
  27.    2.1 Object Definitions ...................................    2
  28.    3. Change Log ............................................    2
  29.    4. Overview ..............................................    3
  30.    4.1 Relation to RFC 1213 .................................    4
  31.    4.2 Relation to RFC 1573 .................................    4
  32.    4.2.1 Layering Model .....................................    4
  33.    4.2.2 Virtual Circuits ...................................    4
  34.    4.2.3 ifTestTable ........................................    4
  35.    4.2.4 ifRcvAddressTable ..................................    5
  36.    4.2.5 ifPhysAddress ......................................    5
  37.    4.2.6 ifType .............................................    6
  38.    5. Definitions ...........................................    6
  39.    6. Acknowledgements ......................................   18
  40.    7. References ............................................   19
  41.    8. Security Considerations ...............................   20
  42.    9. Author's Address ......................................   20
  43.  
  44. 1.  Introduction
  45.  
  46.    This memo defines a portion of the Management Information Base (MIB)
  47.    for use with network management protocols in the Internet community.
  48.    In particular, it defines objects for managing ethernet-like objects.
  49.  
  50.    This memo also includes a MIB module.  This MIB module corrects minor
  51.    errors in the earlier version of this MIB: RFC 1398 [15] and also
  52.    re-specifies that MIB in a manner which is both compliant to the
  53.    SNMPv2 SMI and semantically-identical to the existing SNMPv1-based
  54.    definitions.
  55.  
  56.  
  57.  
  58. Kastenholz                                                      [Page 1]
  59.  
  60. RFC 1650                   Ethernet-Like MIB                 August 1994
  61.  
  62.  
  63. 2.  The SNMPv2 Network Management Framework
  64.  
  65.    The SNMPv2 Network Management Framework consists of four major
  66.    components.  They are:
  67.  
  68.       o    RFC 1442 [16] which defines the SMI, the mechanisms used
  69.            for describing and naming objects for the purpose of
  70.            management.
  71.  
  72.       o    STD 17, RFC 1213 [6] defines MIB-II, the core set of
  73.            managed objects for the Internet suite of protocols.
  74.  
  75.       o    RFC 1445 [17] which defines the administrative and other
  76.            architectural aspects of the framework.
  77.  
  78.       o    RFC 1448 [18] which defines the protocol used for network
  79.            access to managed objects.
  80.  
  81.    The Framework permits new objects to be defined for the purpose of
  82.    experimentation and evaluation.
  83.  
  84. 2.1.  Object Definitions
  85.  
  86.    Managed objects are accessed via a virtual information store, termed
  87.    the Management Information Base or MIB.  Objects in the MIB are
  88.    defined using the subset of Abstract Syntax Notation One (ASN.1) [7]
  89.    defined in the SMI [16].  In particular, each object object type is
  90.    named by an OBJECT IDENTIFIER, an administratively assigned name.
  91.    The object type together with an object instance serves to uniquely
  92.    identify a specific instantiation of the object.  For human
  93.    convenience, we often use a textual string, termed the descriptor, to
  94.    refer to the object type.
  95.  
  96. 3.  Change Log
  97.  
  98.    This section enumerates changes made to RFC 1398 to produce this
  99.    document.
  100.  
  101.       (1)   The "boilerplate" was changed to reflect the new
  102.             boilerplate for SNMPv2.
  103.  
  104.       (2)   A section describing the applicability of various parts
  105.             of RFC 1573 to ethernet-like interfaces has been added.
  106.  
  107.       (3)   A minor error in the description of the TDR test was
  108.             fixed.
  109.  
  110.  
  111.  
  112.  
  113.  
  114. Kastenholz                                                      [Page 2]
  115.  
  116. RFC 1650                   Ethernet-Like MIB                 August 1994
  117.  
  118.  
  119.       (4)   A loopback test was defined to replace the standard
  120.             loopback test that was defined in RFC 1229.
  121.  
  122.       (5)   The description of dot3CollFrequencies was made a bit
  123.             clearer.
  124.  
  125.       (6)   A new object, EtherChipset, has been added. This object
  126.             replaces the ifExtnsChipSet object, which has been
  127.             removed per the Interface MIB Evolution effort.
  128.  
  129.       (7)   Several minor editorial changes, spelling corrections,
  130.             grammar and punctuation corrections, and so forth, were
  131.             made.
  132.  
  133. 4.  Overview
  134.  
  135.    Instances of these object types represent attributes of an interface
  136.    to an ethernet-like communications medium.  At present, ethernet-like
  137.    media are identified by three values of the ifType object in the
  138.    Internet-standard MIB:
  139.  
  140.          ethernet-csmacd(6)
  141.          iso88023-csmacd(7)
  142.          starLan(11)
  143.  
  144.    For these interfaces, the value of the ifSpecific variable in the
  145.    MIB-II [6] has the OBJECT IDENTIFIER value:
  146.  
  147.       dot3    OBJECT IDENTIFER ::= { transmission 7 }
  148.  
  149.    The definitions presented here are based on the IEEE 802.3 Layer
  150.    Management Specification [9], as originally interpreted by Frank
  151.    Kastenholz then of Interlan in [10].  Implementors of these MIB
  152.    objects should note that the IEEE document explicitly describes (in
  153.    the form of Pascal pseudocode) when, where, and how various MAC
  154.    attributes are measured.  The IEEE document also describes the
  155.    effects of MAC actions that may be invoked by manipulating instances
  156.    of the MIB objects defined here.
  157.  
  158.    To the extent that some of the attributes defined in [9] are
  159.    represented by previously defined objects in the Internet-standard
  160.    MIB or in the Generic Interface Extensions MIB [11], such attributes
  161.    are not redundantly represented by objects defined in this memo.
  162.    Among the attributes represented by objects defined in other memos
  163.    are the number of octets transmitted or received on a particular
  164.    interface, the number of frames transmitted or received on a
  165.    particular interface, the promiscuous status of an interface, the MAC
  166.    address of an interface, and multicast information associated with an
  167.  
  168.  
  169.  
  170. Kastenholz                                                      [Page 3]
  171.  
  172. RFC 1650                   Ethernet-Like MIB                 August 1994
  173.  
  174.  
  175.    interface.
  176.  
  177. 4.1.  Relation to RFC 1213
  178.  
  179.    This section applies only when this MIB is used in conjunction with
  180.    the "old" (i.e., pre-RFC 1573) interface group.
  181.  
  182.    The relationship between an ethernet-like interface and an interface
  183.    in the context of the Internet-standard MIB is one-to-one.  As such,
  184.    the value of an ifIndex object instance can be directly used to
  185.    identify corresponding instances of the objects defined herein.
  186.  
  187. 4.2.  Relation to RFC 1573
  188.  
  189.    RFC 1573, the Interface MIB Evolution, requires that any MIB which is
  190.    an adjunct of the Interface MIB, clarify specific areas within the
  191.    Interface MIB.  These areas were intentionally left vague in RFC 1573
  192.    to avoid over constraining the MIB, thereby precluding management of
  193.    certain media-types.
  194.  
  195.    Section 3.3 of RFC 1573 enumerates several areas which a media-
  196.    specific MIB must clarify.  Each of these areas is addressed in a
  197.    following subsection.  The implementor is referred to RFC 1573 in
  198.    order to understand the general intent of these areas.
  199.  
  200. 4.2.1.  Layering Model
  201.  
  202.    This MIB does not provide for layering.  There are no sublayers.
  203.  
  204.    EDITOR'S NOTE:
  205.  
  206.       I could forsee the development of an 802.2 and enet-transceiver
  207.       MIB.  They could be higher and lower sublayers, respectively.  All
  208.       that THIS document should do is allude to the possibilities and
  209.       urge the implementor to be aware of the possibility and that they
  210.       may have requirements which supersede the requirements in this
  211.       document.
  212.  
  213. 4.2.2.  Virtual Circuits
  214.  
  215.       This medium does not support virtual circuits and this area is not
  216.       applicable to this MIB.
  217.  
  218. 4.2.3.  ifTestTable
  219.  
  220.       This MIB defines two tests for media which are instumented with
  221.       this MIB; TDR and Loopback.  Implementation of these tests is not
  222.       required.  Many common interface chips do not support one or both
  223.  
  224.  
  225.  
  226. Kastenholz                                                      [Page 4]
  227.  
  228. RFC 1650                   Ethernet-Like MIB                 August 1994
  229.  
  230.  
  231.       of these tests.
  232.  
  233.       These two tests are provided as a convenience, allowing a common
  234.       method to invoke the test.
  235.  
  236.       Standard MIBs do not include objects in which to return the
  237.       results of the TDR test.  Any needed objects MUST be provided in
  238.       the vendor specific MIB.
  239.  
  240. 4.2.4.  ifRcvAddressTable
  241.  
  242.       This table contains all IEEE 802.3 addresses, unicast, multicast,
  243.       and broadcast, for which this interface will receive packets and
  244.       forward them up to a higher layer entity for local consumption.
  245.       The format of the address, contained in ifRcvAddressAddress, is
  246.       the same as for ifPhysAddress.
  247.  
  248.       In the event that the interface is part of a MAC bridge, this
  249.       table does not include unicast addresses which are accepted for
  250.       possible forwarding out some other port.  This table is explicitly
  251.       not intended to provide a bridge address filtering mechanism.
  252.  
  253. 4.2.5.  ifPhysAddress
  254.  
  255.       This object contains the IEEE 802.3 address which is placed in the
  256.       source-address field of any Ethernet, Starlan, or IEEE 802.3
  257.       frames that originate at this interface.  Usually this will be
  258.       kept in ROM on the interface hardware.  Some systems may set this
  259.       address via software.
  260.  
  261.       In a system where there are several such addresses the designer
  262.       has a tougher choice.  The address chosen should be the one most
  263.       likely to be of use to network management (e.g.  the address
  264.       placed in ARP responses for systems which are primarily IP
  265.       systems).
  266.  
  267.       If the designer truly can not chose, use of the factory- provided
  268.       ROM address is suggested.
  269.  
  270.       If the address can not be determined, an octet string of zero
  271.       length should be returned.
  272.  
  273.       The address is stored in binary in this object.  The address is
  274.       stored in "canonical" bit order, that is, the Group Bit is
  275.       positioned as the low-order bit of the first octet.  Thus, the
  276.       first byte of a multicast address would have the bit 0x01 set.
  277.  
  278.  
  279.  
  280.  
  281.  
  282. Kastenholz                                                      [Page 5]
  283.  
  284. RFC 1650                   Ethernet-Like MIB                 August 1994
  285.  
  286.  
  287. 4.2.6.  ifType
  288.  
  289.       This MIB applies to interfaces which have any of the following
  290.       three ifType values:
  291.  
  292.          ethernet-csmacd(6)
  293.          iso88023-csmacd(7)
  294.          starLan(11)
  295.  
  296.    Interfaces with any of these ifType values map to the EtherLike-MIB
  297.    in the same manner.  The EtherLike-MIB applies equally to all three
  298.    types; there are no implementation differences.
  299.  
  300. 5.  Definitions
  301.  
  302. EtherLike-MIB DEFINITIONS ::= BEGIN
  303.  
  304.    IMPORTS
  305.        MODULE-IDENTITY, OBJECT-TYPE, Counter32, Gauge32,
  306.        Integer32,                               FROM SNMPv2-SMI
  307.        TEXTUAL-CONVENTION, PhysAddress,         FROM SNMPv2-TC
  308.        MODULE-COMPLIANCE, OBJECT-GROUP          FROM SNMPv2-CONF
  309.        ifIndex, ifEntry                         FROM IF-MIB
  310.        mib-2                                    FROM RFC1213-MIB;
  311.  
  312.    etherMIB MODULE-IDENTITY
  313.        LAST-UPDATED "9402030400Z"
  314.        ORGANIZATION "IETF Interfaces MIB Working Group"
  315.        CONTACT-INFO
  316.  
  317.         "        Frank Kastenholz
  318.  
  319.          Postal: FTP Software
  320.                  2 High Street
  321.                  North Andover, MA 01845
  322.                  US
  323.  
  324.             Tel: +1 508 685 4000
  325.          E-Mail: kasten@ftp.com"
  326.        DESCRIPTION
  327.      "The MIB module to describe generic objects for
  328.      Ethernet-like network interfaces. This MIB is an
  329.      updated version of the Ethernet-like MIB in RFC
  330.      1398."
  331.        ::= { mib-2 35 }
  332.  
  333.    etherMIBObjects OBJECT IDENTIFIER ::= { etherMIB 1 }
  334.  
  335.  
  336.  
  337.  
  338. Kastenholz                                                      [Page 6]
  339.  
  340. RFC 1650                   Ethernet-Like MIB                 August 1994
  341.  
  342.  
  343.    dot3    OBJECT IDENTIFIER ::= { transmission 7 }
  344.  
  345.    -- the Ethernet-like Statistics group
  346.  
  347.     dot3StatsTable  OBJECT-TYPE
  348.          SYNTAX     SEQUENCE OF Dot3StatsEntry
  349.          MAX-ACCESS not-accessible
  350.          STATUS     current
  351.          DESCRIPTION
  352.           "Statistics for a collection of ethernet-like
  353.           interfaces attached to a particular system."
  354.          ::= { dot3 2 }
  355.  
  356.  
  357.     dot3StatsEntry   OBJECT-TYPE
  358.          SYNTAX      Dot3StatsEntry
  359.          MAX-ACCESS  not-accessible
  360.          STATUS      current
  361.          DESCRIPTION
  362.            "Statistics for a particular interface to an
  363.            ethernet-like medium."
  364.          INDEX       { dot3StatsIndex }
  365.          ::= { dot3StatsTable 1 }
  366.  
  367.     Dot3StatsEntry ::= SEQUENCE {
  368.          dot3StatsIndex                      INTEGER,
  369.          dot3StatsAlignmentErrors            Counter32,
  370.          dot3StatsFCSErrors                  Counter32,
  371.          dot3StatsSingleCollisionFrames      Counter32,
  372.          dot3StatsMultipleCollisionFrames    Counter32,
  373.          dot3StatsSQETestErrors              Counter32,
  374.          dot3StatsDeferredTransmissions      Counter32,
  375.          dot3StatsLateCollisions             Counter32,
  376.          dot3StatsExcessiveCollisions        Counter32,
  377.          dot3StatsInternalMacTransmitErrors  Counter32,
  378.          dot3StatsCarrierSenseErrors         Counter32,
  379.          dot3StatsFrameTooLongs              Counter32,
  380.          dot3StatsInternalMacReceiveErrors   Counter32,
  381.                  dot3StatsEtherChipSet               OBJECT IDENTIFIER
  382.     }
  383.  
  384.     dot3StatsIndex   OBJECT-TYPE
  385.          SYNTAX      INTEGER
  386.          ACCESS      read-only
  387.          STATUS      mandatory
  388.          DESCRIPTION
  389.            "An index value that uniquely identifies an
  390.            interface to an ethernet-like medium.  The
  391.  
  392.  
  393.  
  394. Kastenholz                                                      [Page 7]
  395.  
  396. RFC 1650                   Ethernet-Like MIB                 August 1994
  397.  
  398.  
  399.            interface identified by a particular value of
  400.            this index is the same interface as identified
  401.            by the same value of ifIndex."
  402.          ::= { dot3StatsEntry 1 }
  403.  
  404.     dot3StatsAlignmentErrors   OBJECT-TYPE
  405.          SYNTAX     Counter32
  406.          MAX-ACCESS read-only
  407.          STATUS     current
  408.          DESCRIPTION
  409.           "A count of frames received on a particular
  410.           interface that are not an integral number of
  411.           octets in length and do not pass the FCS check.
  412.  
  413.           The count represented by an instance of this
  414.           object is incremented when the alignmentError
  415.           status is returned by the MAC service to the
  416.           LLC (or other MAC user). Received frames for
  417.           which multiple error conditions obtain are,
  418.           according to the conventions of IEEE 802.3
  419.           Layer Management, counted exclusively according
  420.           to the error status presented to the LLC."
  421.          REFERENCE
  422.          "IEEE 802.3 Layer Management"
  423.          ::= { dot3StatsEntry 2 }
  424.  
  425.  
  426.     dot3StatsFCSErrors   OBJECT-TYPE
  427.          SYNTAX      Counter32
  428.          MAX-ACCESS  read-only
  429.          STATUS      current
  430.          DESCRIPTION
  431.          "A count of frames received on a particular
  432.          interface that are an integral number of octets
  433.          in length but do not pass the FCS check.
  434.  
  435.          The count represented by an instance of this
  436.          object is incremented when the frameCheckError
  437.          status is returned by the MAC service to the
  438.          LLC (or other MAC user). Received frames for
  439.          which multiple error conditions obtain are,
  440.          according to the conventions of IEEE 802.3
  441.          Layer Management, counted exclusively according
  442.          to the error status presented to the LLC."
  443.          REFERENCE
  444.          "IEEE 802.3 Layer Management"
  445.          ::= { dot3StatsEntry 3 }
  446.  
  447.  
  448.  
  449.  
  450. Kastenholz                                                      [Page 8]
  451.  
  452. RFC 1650                   Ethernet-Like MIB                 August 1994
  453.  
  454.  
  455.     dot3StatsSingleCollisionFrames   OBJECT-TYPE
  456.          SYNTAX      Counter32
  457.          MAX-ACCESS  read-only
  458.          STATUS      current
  459.          DESCRIPTION
  460.          "A count of successfully transmitted frames on
  461.          a particular interface for which transmission
  462.          is inhibited by exactly one collision.
  463.  
  464.          A frame that is counted by an instance of this
  465.          object is also counted by the corresponding
  466.          instance of either the ifOutUcastPkts,
  467.          ifOutMulticastPkts, or ifOutBroadcastPkts,
  468.          and is not counted by the corresponding
  469.          instance of the dot3StatsMultipleCollisionFrames
  470.          object."
  471.          REFERENCE
  472.          "IEEE 802.3 Layer Management"
  473.          ::= { dot3StatsEntry 4 }
  474.  
  475.  
  476.     dot3StatsMultipleCollisionFrames   OBJECT-TYPE
  477.          SYNTAX      Counter32
  478.          MAX-ACCESS  read-only
  479.          STATUS      current
  480.          DESCRIPTION
  481.          "A count of successfully transmitted frames on
  482.          a particular interface for which transmission
  483.           is inhibited by more than one collision.
  484.  
  485.          A frame that is counted by an instance of this
  486.          object is also counted by the corresponding
  487.          instance of either the ifOutUcastPkts,
  488.          ifOutMulticastPkts, or ifOutBroadcastPkts,
  489.          and is not counted by the corresponding
  490.          instance of the dot3StatsSingleCollisionFrames
  491.          object."
  492.          REFERENCE
  493.          "IEEE 802.3 Layer Management"
  494.          ::= { dot3StatsEntry 5 }
  495.  
  496.  
  497.     dot3StatsSQETestErrors   OBJECT-TYPE
  498.          SYNTAX     Counter32
  499.          MAX-ACCESS read-only
  500.          STATUS     current
  501.          DESCRIPTION
  502.          "A count of times that the SQE TEST ERROR
  503.  
  504.  
  505.  
  506. Kastenholz                                                      [Page 9]
  507.  
  508. RFC 1650                   Ethernet-Like MIB                 August 1994
  509.  
  510.  
  511.          message is generated by the PLS sublayer for a
  512.          particular interface. The SQE TEST ERROR
  513.          message is defined in section 7.2.2.2.4 of
  514.          ANSI/IEEE 802.3-1985 and its generation is
  515.          described in section 7.2.4.6 of the same
  516.          document."
  517.          REFERENCE
  518.          "ANSI/IEEE Std 802.3-1985 Carrier Sense
  519.          Multiple Access with Collision Detection Access
  520.          Method and Physical Layer Specifications"
  521.          ::= { dot3StatsEntry 6 }
  522.  
  523.     dot3StatsDeferredTransmissions   OBJECT-TYPE
  524.          SYNTAX      Counter32
  525.          MAX-ACCESS  read-only
  526.          STATUS      current
  527.          DESCRIPTION
  528.          "A count of frames for which the first
  529.          transmission attempt on a particular interface
  530.          is delayed because the medium is busy.
  531.  
  532.          The count represented by an instance of this
  533.          object does not include frames involved in
  534.          collisions."
  535.          REFERENCE
  536.          "IEEE 802.3 Layer Management"
  537.          ::= { dot3StatsEntry 7 }
  538.  
  539.     dot3StatsLateCollisions   OBJECT-TYPE
  540.          SYNTAX      Counter32
  541.          MAX-ACCESS  read-only
  542.          STATUS      current
  543.          DESCRIPTION
  544.          "The number of times that a collision is
  545.          detected on a particular interface later than
  546.          512 bit-times into the transmission of a
  547.          packet.
  548.  
  549.          Five hundred and twelve bit-times corresponds
  550.          to 51.2 microseconds on a 10 Mbit/s system. A
  551.          (late) collision included in a count
  552.          represented by an instance of this object is
  553.          also considered as a (generic) collision for
  554.          purposes of other collision-related
  555.          statistics."
  556.          REFERENCE
  557.          "IEEE 802.3 Layer Management"
  558.          ::= { dot3StatsEntry 8 }
  559.  
  560.  
  561.  
  562. Kastenholz                                                     [Page 10]
  563.  
  564. RFC 1650                   Ethernet-Like MIB                 August 1994
  565.  
  566.  
  567.     dot3StatsExcessiveCollisions   OBJECT-TYPE
  568.          SYNTAX    Counter32
  569.          MAX-ACCESS    read-only
  570.          STATUS    current
  571.          DESCRIPTION
  572.          "A count of frames for which transmission on a
  573.          particular interface fails due to excessive
  574.          collisions."
  575.          REFERENCE
  576.          "IEEE 802.3 Layer Management"
  577.          ::= { dot3StatsEntry 9 }
  578.  
  579.  
  580.     dot3StatsInternalMacTransmitErrors   OBJECT-TYPE
  581.          SYNTAX    Counter32
  582.          MAX-ACCESS    read-only
  583.          STATUS    current
  584.          DESCRIPTION
  585.          "A count of frames for which transmission on a
  586.          particular interface fails due to an internal
  587.          MAC sublayer transmit error. A frame is only
  588.          counted by an instance of this object if it is
  589.          not counted by the corresponding instance of
  590.          either the dot3StatsLateCollisions object, the
  591.          dot3StatsExcessiveCollisions object, or the
  592.          dot3StatsCarrierSenseErrors object.
  593.  
  594.          The precise meaning of the count represented by
  595.          an instance of this object is implementation-
  596.          specific.  In particular, an instance of this
  597.          object may represent a count of transmission
  598.          errors on a particular interface that are not
  599.          otherwise counted."
  600.          REFERENCE
  601.          "IEEE 802.3 Layer Management"
  602.          ::= { dot3StatsEntry 10 }
  603.  
  604.     dot3StatsCarrierSenseErrors   OBJECT-TYPE
  605.          SYNTAX    Counter32
  606.          MAX-ACCESS    read-only
  607.          STATUS    current
  608.          DESCRIPTION
  609.          "The number of times that the carrier sense
  610.          condition was lost or never asserted when
  611.          attempting to transmit a frame on a particular
  612.          interface.
  613.  
  614.          The count represented by an instance of this
  615.  
  616.  
  617.  
  618. Kastenholz                                                     [Page 11]
  619.  
  620. RFC 1650                   Ethernet-Like MIB                 August 1994
  621.  
  622.  
  623.          object is incremented at most once per
  624.          transmission attempt, even if the carrier sense
  625.          condition fluctuates during a transmission
  626.          attempt."
  627.          REFERENCE
  628.          "IEEE 802.3 Layer Management"
  629.          ::= { dot3StatsEntry 11 }
  630.  
  631.     -- { dot3StatsEntry 12 } is not assigned
  632.  
  633.     dot3StatsFrameTooLongs   OBJECT-TYPE
  634.          SYNTAX    Counter32
  635.          MAX-ACCESS    read-only
  636.          STATUS    current
  637.          DESCRIPTION
  638.          "A count of frames received on a particular
  639.          interface that exceed the maximum permitted
  640.          frame size.
  641.  
  642.          The count represented by an instance of this
  643.          object is incremented when the frameTooLong
  644.          status is returned by the MAC service to the
  645.          LLC (or other MAC user). Received frames for
  646.          which multiple error conditions obtain are,
  647.          according to the conventions of IEEE 802.3
  648.          Layer Management, counted exclusively according
  649.          to the error status presented to the LLC."
  650.          REFERENCE
  651.          "IEEE 802.3 Layer Management"
  652.          ::= { dot3StatsEntry 13 }
  653.  
  654.     -- { dot3StatsEntry 14 } is not assigned
  655.  
  656.     -- { dot3StatsEntry 15 } is not assigned
  657.  
  658.     dot3StatsInternalMacReceiveErrors   OBJECT-TYPE
  659.          SYNTAX    Counter32
  660.          MAX-ACCESS    read-only
  661.          STATUS    current
  662.          DESCRIPTION
  663.          "A count of frames for which reception on a
  664.          particular interface fails due to an internal
  665.          MAC sublayer receive error. A frame is only
  666.          counted by an instance of this object if it is
  667.          not counted by the corresponding instance of
  668.          either the dot3StatsFrameTooLongs object, the
  669.          dot3StatsAlignmentErrors object, or the
  670.          dot3StatsFCSErrors object.
  671.  
  672.  
  673.  
  674. Kastenholz                                                     [Page 12]
  675.  
  676. RFC 1650                   Ethernet-Like MIB                 August 1994
  677.  
  678.  
  679.          The precise meaning of the count represented by
  680.          an instance of this object is implementation-
  681.          specific.  In particular, an instance of this
  682.          object may represent a count of receive errors
  683.          on a particular interface that are not
  684.          otherwise counted."
  685.          REFERENCE
  686.          "IEEE 802.3 Layer Management"
  687.          ::= { dot3StatsEntry 16 }
  688.  
  689.     dot3StatsEtherChipSet   OBJECT-TYPE
  690.          SYNTAX        OBJECT IDENTIFIER
  691.          MAX-ACCESS    read-only
  692.          STATUS        current
  693.          DESCRIPTION
  694.          "This object contains an OBJECT IDENTIFIER
  695.          which identifies the chipset used to
  696.          realize the interface. Ethernet-like
  697.          interfaces are typically built out of
  698.          several different chips. The MIB implementor
  699.          is presented with a decision of which chip
  700.          to identify via this object. The implementor
  701.          should identify the chip which is usually
  702.          called the Medium Access Control chip.
  703.          If no such chip is easily identifiable,
  704.          the implementor should identify the chip
  705.          which actually gathers the transmit
  706.          and receive statistics and error
  707.          indications. This would allow a
  708.          manager station to correlate the
  709.          statistics and the chip generating
  710.          them, giving it the ability to take
  711.          into account any known anomalies
  712.          in the chip."
  713.          ::= { dot3StatsEntry 17 }
  714.  
  715.     -- the Ethernet-like Collision Statistics group
  716.  
  717.     -- Implementation of this group is optional; it is appropriate
  718.     -- for all systems which have the necessary metering
  719.  
  720.     dot3CollTable   OBJECT-TYPE
  721.          SYNTAX    SEQUENCE OF Dot3CollEntry
  722.          MAX-ACCESS    not-accessible
  723.          STATUS    current
  724.          DESCRIPTION
  725.          "A collection of collision histograms for a
  726.          particular set of interfaces."
  727.  
  728.  
  729.  
  730. Kastenholz                                                     [Page 13]
  731.  
  732. RFC 1650                   Ethernet-Like MIB                 August 1994
  733.  
  734.  
  735.          ::= { dot3 5 }
  736.  
  737.  
  738.     dot3CollEntry   OBJECT-TYPE
  739.          SYNTAX    Dot3CollEntry
  740.          MAX-ACCESS    not-accessible
  741.          STATUS    current
  742.          DESCRIPTION
  743.          "A cell in the histogram of per-frame
  744.          collisions for a particular interface.  An
  745.          instance of this object represents the
  746.          frequency of individual MAC frames for which
  747.          the transmission (successful or otherwise) on a
  748.          particular interface is accompanied by a
  749.          particular number of media collisions."
  750.          INDEX     { ifIndex, dot3CollCount }
  751.          ::= { dot3CollTable 1 }
  752.  
  753.     Dot3CollEntry ::= SEQUENCE {
  754.          dot3CollCount        INTEGER,
  755.          dot3CollFrequencies  Counter32
  756.     }
  757.  
  758.     -- { dot3CollEntry 1 } is no longer in use
  759.  
  760.     dot3CollCount   OBJECT-TYPE
  761.          SYNTAX    INTEGER (1..16)
  762.          MAX-ACCESS    not-accessible
  763.          STATUS    current
  764.          DESCRIPTION
  765.          "The number of per-frame media collisions for
  766.          which a particular collision histogram cell
  767.          represents the frequency on a particular
  768.          interface."
  769.          ::= { dot3CollEntry 2 }
  770.  
  771.  
  772.     dot3CollFrequencies   OBJECT-TYPE
  773.          SYNTAX    Counter32
  774.          MAX-ACCESS    read-only
  775.          STATUS    current
  776.          DESCRIPTION
  777.          "A count of individual MAC frames for which the
  778.          transmission (successful or otherwise) on a
  779.          particular interface occurs after the
  780.          frame has experienced exactly the number
  781.          of collisions in the associated
  782.          dot3CollCount object.
  783.  
  784.  
  785.  
  786. Kastenholz                                                     [Page 14]
  787.  
  788. RFC 1650                   Ethernet-Like MIB                 August 1994
  789.  
  790.  
  791.          For example, a frame which is transmitted
  792.          on interface 77 after experiencing
  793.          exactly 4 collisions would be indicated
  794.          by incrementing only dot3CollFrequencies.77.4.
  795.          No other instance of dot3CollFrequencies would
  796.          be incremented in this example."
  797.          ::= { dot3CollEntry 3 }
  798.  
  799.     --  802.3 Tests
  800.  
  801.     dot3Tests   OBJECT IDENTIFIER ::= { dot3 6 }
  802.  
  803.     dot3Errors  OBJECT IDENTIFIER ::= { dot3 7 }
  804.  
  805.  
  806.     --  TDR Test
  807.  
  808.     -- The Time-Domain Reflectometry (TDR) test is specific
  809.     -- to ethernet-like interfaces with the exception of
  810.     -- 10BaseT and 10BaseF. The TDR value may be useful
  811.     -- in determining the approximate distance to a cable fault.
  812.     -- It is advisable to repeat this test to check for a
  813.     -- consistent resulting TDR value, to verify that there
  814.     -- is a fault.
  815.  
  816.     dot3TestTdr OBJECT IDENTIFIER ::= { dot3Tests 1 }
  817.  
  818.     -- A TDR test returns as its result the time interval,
  819.     -- measured in 10 MHz ticks or 100 nsec units, between
  820.     -- the start of TDR test transmission and the subsequent
  821.     -- detection of a collision or deassertion of carrier.  On
  822.     -- successful completion of a TDR test, the result is
  823.     -- stored as the value of the appropriate instance of the
  824.     -- MIB object dot3TestTdrValue, and the OBJECT IDENTIFIER
  825.     -- of that instanceis stored in the corresponding instance
  826.     -- of ifExtnsTestCode (thereby indicating where the
  827.     -- result has been stored).
  828.  
  829.  
  830.     -- Loopback Test
  831.  
  832.     -- Another test is the full-duplex loopback test.
  833.     -- This test configures the MAC chip and executes
  834.     -- an internal loopback test of memory, data paths,
  835.     -- and the MAC chip logic.  This loopback test can
  836.     -- only be executed if the interface is offline.
  837.     -- Once the test has completed, the MAC chip should
  838.     -- be reinitialized for network operation, but it
  839.  
  840.  
  841.  
  842. Kastenholz                                                     [Page 15]
  843.  
  844. RFC 1650                   Ethernet-Like MIB                 August 1994
  845.  
  846.  
  847.     -- should remain offline.
  848.  
  849.     dot3TestLoopBack OBJECT IDENTIFIER ::= { dot3Tests 2 }
  850.  
  851.     -- If an error occurs during a test, the object
  852.     -- ifTestResult (defined in RFC1573) will be set
  853.     -- to failed(7).  The following two OBJECT
  854.     -- IDENTIFIERs may be used to provided more
  855.     -- information as values for ifTestCode.
  856.  
  857.              -- couldn't initialize MAC chip for test
  858.     dot3ErrorInitError     OBJECT IDENTIFIER ::= { dot3Errors 1 }
  859.  
  860.              -- expected data not received (or not
  861.              -- received correctly) in loopback test
  862.     dot3ErrorLoopbackError OBJECT IDENTIFIER ::= { dot3Errors 2 }
  863.  
  864.     -- RFC1573 does away with the interface chipset object.
  865.     -- The following OBJECT IDENTIFIER definitions are
  866.     -- retained for purposes of backwards compatibility
  867.     -- with pre-RFC1573 systems.
  868.     --  802.3 Hardware Chipsets
  869.  
  870.     -- The object ifExtnsChipSet is provided in RFC1229 to
  871.     -- identify the MAC hardware used to communicate on an
  872.     -- interface.  The following hardware chipsets are
  873.     -- provided for 802.3:
  874.  
  875.     dot3ChipSets          OBJECT IDENTIFIER ::= { dot3 8 }
  876.     dot3ChipSetAMD        OBJECT IDENTIFIER ::= { dot3ChipSets 1 }
  877.     dot3ChipSetAMD7990    OBJECT IDENTIFIER ::= { dot3ChipSetAMD 1 }
  878.     dot3ChipSetAMD79900   OBJECT IDENTIFIER ::= { dot3ChipSetAMD 2 }
  879.     dot3ChipSetAMD79C940  OBJECT IDENTIFIER ::= { dot3ChipSetAMD 3 }
  880.  
  881.     dot3ChipSetIntel      OBJECT IDENTIFIER ::= { dot3ChipSets 2 }
  882.     dot3ChipSetIntel82586 OBJECT IDENTIFIER ::= { dot3ChipSetIntel 1 }
  883.     dot3ChipSetIntel82596 OBJECT IDENTIFIER ::= { dot3ChipSetIntel 2 }
  884.  
  885.     dot3ChipSetSeeq       OBJECT IDENTIFIER ::= { dot3ChipSets 3 }
  886.     dot3ChipSetSeeq8003   OBJECT IDENTIFIER ::= { dot3ChipSetSeeq 1 }
  887.  
  888.     dot3ChipSetNational      OBJECT IDENTIFIER ::= { dot3ChipSets 4 }
  889.     dot3ChipSetNational8390  OBJECT IDENTIFIER ::=
  890.                                { dot3ChipSetNational 1 }
  891.     dot3ChipSetNationalSonic OBJECT IDENTIFIER ::=
  892.                                { dot3ChipSetNational 2 }
  893.  
  894.     dot3ChipSetFujitsu       OBJECT IDENTIFIER ::= { dot3ChipSets 5 }
  895.  
  896.  
  897.  
  898. Kastenholz                                                     [Page 16]
  899.  
  900. RFC 1650                   Ethernet-Like MIB                 August 1994
  901.  
  902.  
  903.     dot3ChipSetFujitsu86950  OBJECT IDENTIFIER ::=
  904.                                { dot3ChipSetFujitsu 1 }
  905.  
  906.     dot3ChipSetDigital       OBJECT IDENTIFIER ::= { dot3ChipSets 6 }
  907.     dot3ChipSetDigitalDC21040  OBJECT IDENTIFIER ::=
  908.                                { dot3ChipSetDigital 1 }
  909.  
  910.     -- For those chipsets not represented above, OBJECT IDENTIFIER
  911.     -- assignment is required in other documentation, e.g., assignment
  912.     -- within that part of the registration tree delegated to
  913.     -- individual enterprises (see RFC1155).
  914.  
  915.    -- conformance information
  916.  
  917.    etherConformance OBJECT IDENTIFIER ::= { etherMIB 2 }
  918.  
  919.    etherGroups      OBJECT IDENTIFIER ::= { etherConformance 1 }
  920.    etherCompliances OBJECT IDENTIFIER ::= { etherConformance 2 }
  921.  
  922.  
  923.    -- compliance statements
  924.  
  925.    etherCompliance MODULE-COMPLIANCE
  926.        STATUS  current
  927.        DESCRIPTION
  928.      "The compliance statement for SNMPv2 entities which
  929.      have ethernet-like network interfaces."
  930.  
  931.        MODULE  -- this module
  932.  MANDATORY-GROUPS { etherStatsGroup }
  933.  
  934.  GROUP       etherCollisionTableGroup
  935.  DESCRIPTION
  936.      "This group is optional. It is appropriate for
  937.       all systems which have the necessary metering.
  938.       Implementation in such systems is highly
  939.       recommended."
  940.        ::= { etherCompliances 1 }
  941.  
  942.    -- units of conformance
  943.  
  944.    etherStatsGroup    OBJECT-GROUP
  945.        OBJECTS { dot3StatsIndex, dot3StatsAlignmentErrors,
  946.        dot3StatsFCSErrors,
  947.        dot3StatsSingleCollisionFrames,
  948.        dot3StatsMultipleCollisionFrames,
  949.        dot3StatsSQETestErrors,
  950.        dot3StatsDeferredTransmissions,
  951.  
  952.  
  953.  
  954. Kastenholz                                                     [Page 17]
  955.  
  956. RFC 1650                   Ethernet-Like MIB                 August 1994
  957.  
  958.  
  959.        dot3StatsLateCollisions,
  960.        dot3StatsExcessiveCollisions,
  961.        dot3StatsInternalMacTransmitErrors,
  962.        dot3StatsCarrierSenseErrors,
  963.        dot3StatsFrameTooLongs,
  964.        dot3StatsInternalMacReceiveErrors,
  965.        dot3StatsEtherChipSet}
  966.        STATUS  current
  967.        DESCRIPTION
  968.      "A collection of objects providing information
  969.      applicable to all ethernet-like network interfaces."
  970.        ::= { etherGroups 1 }
  971.  
  972.  
  973.    etherCollisionTableGroup    OBJECT-GROUP
  974.        OBJECTS { dot3CollCount, dot3CollFrequencies }
  975.        STATUS  current
  976.        DESCRIPTION
  977.      "A collection of objects providing a histogram
  978.      of packets successfully transmitted after
  979.      experiencing exactly N collisions."
  980.        ::= { etherGroups 2 }
  981. END
  982.  
  983. 6.  Acknowledgements
  984.  
  985.    This document was produced by the Ethernet MIB Working Group.
  986.  
  987.    This document is based on the Proposed Standard Ethernet MIB, RFC
  988.    1284 [14], of which Jihn Cook of Chipcom was the editor.  The
  989.    Ethernet MIB Working Group gathered implementation experience of the
  990.    variables specified in RFC 1284 and used that information to develop
  991.    this revised MIB.
  992.  
  993.    RFC 1284, in turn, is based on a document written by Frank Kastenholz
  994.    of Interlan entitled IEEE 802.3 Layer Management Draft M compatible
  995.    MIB for TCP/IP Networks [10].  This document has been modestly
  996.    reworked, initially by the SNMP Working Group, and then by the
  997.    Transmission Working Group, to reflect the current conventions for
  998.    defining objects for MIB interfaces.  James Davin, of the MIT
  999.    Laboratory for Computer Science, and Keith McCloghrie of Hughes LAN
  1000.    Systems, contributed to later drafts of this memo. Marshall Rose of
  1001.    Performance Systems International, Inc. converted the document into
  1002.    its current concise format. Anil Rijsinghani of DEC contributed text
  1003.    that more adequately describes the TDR test.  Thanks to Frank
  1004.    Kastenholz of Interlan and Louis Steinberg of IBM for their
  1005.    experimentation.
  1006.  
  1007.  
  1008.  
  1009.  
  1010. Kastenholz                                                     [Page 18]
  1011.  
  1012. RFC 1650                   Ethernet-Like MIB                 August 1994
  1013.  
  1014.  
  1015. 7.  References
  1016.  
  1017.    [1] Cerf, V., "IAB Recommendations for the Development of Internet
  1018.        Network Management Standards", RFC 1052, NRI, April 1988.
  1019.  
  1020.    [2] Cerf, V., "Report of the Second Ad Hoc Network Management Review
  1021.        Group," RFC 1109, NRI, August 1989.
  1022.  
  1023.    [3] Rose M., and K. McCloghrie, "Structure and Identification of
  1024.        Management Information for TCP/IP-based internets", STD 16, RFC
  1025.        1155, Performance Systems International, Hughes LAN Systems, May
  1026.        1990.
  1027.  
  1028.    [4] McCloghrie K., and M. Rose, "Management Information Base for
  1029.        Network Management of TCP/IP-based internets", RFC 1156, Hughes
  1030.        LAN Systems, Performance Systems International, May 1990.
  1031.  
  1032.    [5] Case, J., Fedor, M., Schoffstall, M., and J. Davin, "Simple
  1033.        Network Management Protocol", STD 15, RFC 1157, SNMP Research,
  1034.        Performance Systems International, Performance Systems
  1035.        International, MIT Laboratory for Computer Science, May 1990.
  1036.  
  1037.    [6] McCloghrie K., and M. Rose, Editors, "Management Information Base
  1038.        for Network Management of TCP/IP-based internets", STD 17, RFC
  1039.        1213, Performance Systems International, March 1991.
  1040.  
  1041.    [7] Information processing systems - Open Systems Interconnection -
  1042.        Specification of Abstract Syntax Notation One (ASN.1),
  1043.        International Organization for Standardization, International
  1044.        Standard 8824, December 1987.
  1045.  
  1046.    [8] Information processing systems - Open Systems Interconnection -
  1047.        Specification of Basic Encoding Rules for Abstract Notation One
  1048.        (ASN.1), International Organization for Standardization,
  1049.        International Standard 8825, December 1987.
  1050.  
  1051.    [9] IEEE, IEEE 802.3 Layer Management, November 1988.
  1052.  
  1053.   [10] Kastenholz, F., "IEEE 802.3 Layer Management Draft compatible MIB
  1054.        for TCP/IP Networks", electronic mail message to mib-
  1055.        wg@nnsc.nsf.net, 9 June 1989.
  1056.  
  1057.   [11] McCloghrie, K., Editor, "Extensions to the Generic-Interface MIB,
  1058.        RFC 1229, Hughes LAN Systems", Inc., May 1991.
  1059.  
  1060.   [12] IEEE, Carrier Sense Multiple Access with Collision Detection
  1061.        (CSMA/CD) Access Method and Physical Layer Specifications,
  1062.        ANSI/IEEE Std 802.3-1985.
  1063.  
  1064.  
  1065.  
  1066. Kastenholz                                                     [Page 19]
  1067.  
  1068. RFC 1650                   Ethernet-Like MIB                 August 1994
  1069.  
  1070.  
  1071.   [13] Rose, M., and K. McCloghrie, Editors, "Concise MIB Definitions",
  1072.        STD 16, RFC 1212, Performance Systems International, Hughes LAN
  1073.        Systems, March 1991.
  1074.  
  1075.   [14] Cook, J., "Definitions of Managed Objects for Ethernet-Like
  1076.        Interface Types", RFC 1284, Chipcom Corporation, December 1991.
  1077.  
  1078.   [15] Kastenholz, F., "Definitions of Managed Objects for the
  1079.        Ethernet-like Interface Types", RFC 1398, FTP Software, Inc.,
  1080.        January 1993.
  1081.  
  1082.   [16] Case, J., McCloghrie, K. Rose, M, and S. Waldbusser, "Structure
  1083.        of Management Information for Version 2 of the Simple Network
  1084.        Management Protocol (SNMPv2)", RFC 1442, SNMP Research, Inc.,
  1085.        Hughes LAN Systems, Dover Beach Consulting, Inc., Carnegie Mellon
  1086.        University, April 1993.
  1087.  
  1088.   [17] Davin, J., and K. McCloghrie, "Administrative Model for Version 2
  1089.        of the Simple Network Management Protocol (SNMPv2)", RFC 1445,
  1090.        Trusted Information Systems, Hughes LAN Systems, April 1993.
  1091.  
  1092.   [18] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Protocol
  1093.        Operations for Version 2 of the Simple Network Management
  1094.        Protocol (SNMPv2)", RFC 1448, SNMP Research, Inc., Hughes LAN
  1095.        Systems, Dover Beach Consulting, Inc., Carnegie Mellon
  1096.        University, April 1993.
  1097.  
  1098.   [19] McCloghrie, K., and F. Kastenholz, "Evolution of the Interfaces
  1099.        Group of MIB-II RFC 1573", Hughes LAN Systems, FTP Software,
  1100.        January 1994.
  1101.  
  1102. 8.  Security Considerations
  1103.  
  1104.    Security issues are not discussed in this memo.
  1105.  
  1106. 9.  Author's Address
  1107.  
  1108.    Frank Kastenholz
  1109.    FTP Software, Inc.
  1110.    2 High Street
  1111.    North Andover, Mass, USA 01845
  1112.  
  1113.    Phone: 508-685-4000
  1114.    EMail: kasten@ftp.com
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122. Kastenholz                                                     [Page 20]
  1123.  
  1124.